Sourced from jest's releases.

Jest 30

Today we are happy to announce the release of Jest 30. This release features a substantial number of changes, fixes, and improvements. While it is one of the largest major releases of Jest ever, we admit that three years for a major release is too long. In the future, we are aiming to make more frequent major releases to keep Jest great for the next decade.

If you want to skip all the news and just get going, run npm install jest@^30.0.0 and follow the migration guide: Upgrading from Jest 29 to 30.

Read the full blog post

Features

• [*] Renamed globalsCleanupMode to globalsCleanup and --waitNextEventLoopTurnForUnhandledRejectionEvents to --waitForUnhandledRejections
• [expect] Add ArrayOf asymmetric matcher for validating array elements. (#15567)
• [babel-jest] Add option excludeJestPreset to allow opting out of babel-preset-jest (#15164)
• [expect] Revert #15038 to fix expect(fn).toHaveBeenCalledWith(expect.objectContaining(...)) when there are multiple calls (#15508)
• [jest-circus, jest-cli, jest-config] Add waitNextEventLoopTurnForUnhandledRejectionEvents flag to minimise performance impact of correct detection of unhandled promise rejections introduced in #14315 (#14681)
• [jest-circus] Add a waitBeforeRetry option to jest.retryTimes (#14738)
• [jest-circus] Add a retryImmediately option to jest.retryTimes (#14696)
• [jest-circus, jest-jasmine2] Allow setupFilesAfterEnv to export an async function (#10962)
• [jest-circus, jest-test-result] Add startedAt timestamp in TestCaseResultObject within onTestCaseResult (#15145)
• [jest-cli] Export buildArgv (#15310)
• [jest-config] [BREAKING] Add mts and cts to default moduleFileExtensions config (#14369)
• [jest-config] [BREAKING] Update testMatch and testRegex default option for supporting mjs, cjs, mts, and cts (#14584)
• [jest-config] Loads config file from provided path in package.json (#14044)
• [jest-config] Allow loading jest.config.cts files (#14070)
• [jest-config] Show rootDir in error message when a preset fails to load (#15194)
• [jest-config] Support loading TS config files using esbuild-register via docblock loader (#15190)
• [jest-config] Allow passing TS config loader options via docblock comment (#15234)
• [jest-config] If Node is running with type stripping enabled, do not require a TS loader (#15480)
• [@jest/core] Group together open handles with the same stack trace (#13417, & #14789)
• [@jest/core] Add perfStats to surface test setup overhead (#14622)
• [@jest/core] [BREAKING] Changed --filter to accept an object with shape { filtered: Array<string> } to match documentation (#13319)
• [@jest/core] Support --outputFile option for --listTests (#14980)
• [@jest/core] Stringify Errors properly with --json flag (#15329)
• [@jest/core, @jest/test-sequencer] [BREAKING] Exposes globalConfig & contexts to TestSequencer (#14535, & #14543)
• [jest-each] Introduce %$ option to add number of the test to its title (#14710)
• [@jest/environment] [BREAKING] Remove deprecated jest.genMockFromModule() (#15042)
• [@jest/environment] [BREAKING] Remove unnecessary defensive code (#15045)
• [jest-environment-jsdom] [BREAKING] Upgrade JSDOM to v22 (#13825)
• [@jest/environment-jsdom-abstract] Introduce new package which abstracts over the jsdom environment, allowing usage of custom versions of JSDOM (#14717)
• [jest-environment-node] Update jest environment with dispose symbols Symbol (#14888 & #14909)
• [expect, @jest/expect] [BREAKING] Add type inference for function parameters in CalledWith assertions (#15129)
• [@jest/expect-utils] Properly compare all types of TypedArrays (#15178)
• [@jest/fake-timers] [BREAKING] Upgrade @sinonjs/fake-timers to v13 (#14544 & #15470)
• [@jest/fake-timers] Exposing new modern timers function advanceTimersToFrame() which advances all timers by the needed milliseconds to execute callbacks currently scheduled with requestAnimationFrame (#14598)
• [jest-matcher-utils] Add SERIALIZABLE_PROPERTIES to allow custom serialization of objects (#14893)
• [jest-mock] Add support for the Explicit Resource Management proposal to use the using keyword with jest.spyOn(object, methodName) (#14895)
• [jest-reporters] Add support for DEC mode 2026 (#15008)
• [jest-resolver] Support file:// URLs as paths (#15154)
• [jest-resolve,jest-runtime,jest-resolve-dependencies] Pass the conditions when resolving stub modules (#15489)
• [jest-runtime] Exposing new modern timers function jest.advanceTimersToFrame() from @jest/fake-timers (#14598)
• [jest-runtime] Support import.meta.filename and import.meta.dirname (available from Node 20.11) (#14854)

... (truncated)

Sourced from jest's changelog.

30.0.0

Features

• [*] Renamed globalsCleanupMode to globalsCleanup and --waitNextEventLoopTurnForUnhandledRejectionEvents to --waitForUnhandledRejections
• [expect] Add ArrayOf asymmetric matcher for validating array elements. (#15567)
• [babel-jest] Add option excludeJestPreset to allow opting out of babel-preset-jest (#15164)
• [expect] Revert #15038 to fix expect(fn).toHaveBeenCalledWith(expect.objectContaining(...)) when there are multiple calls (#15508)
• [jest-circus, jest-cli, jest-config] Add waitNextEventLoopTurnForUnhandledRejectionEvents flag to minimise performance impact of correct detection of unhandled promise rejections introduced in #14315 (#14681)
• [jest-circus] Add a waitBeforeRetry option to jest.retryTimes (#14738)
• [jest-circus] Add a retryImmediately option to jest.retryTimes (#14696)
• [jest-circus, jest-jasmine2] Allow setupFilesAfterEnv to export an async function (#10962)
• [jest-circus, jest-test-result] Add startedAt timestamp in TestCaseResultObject within onTestCaseResult (#15145)
• [jest-cli] Export buildArgv (#15310)
• [jest-config] [BREAKING] Add mts and cts to default moduleFileExtensions config (#14369)
• [jest-config] [BREAKING] Update testMatch and testRegex default option for supporting mjs, cjs, mts, and cts (#14584)
• [jest-config] Loads config file from provided path in package.json (#14044)
• [jest-config] Allow loading jest.config.cts files (#14070)
• [jest-config] Show rootDir in error message when a preset fails to load (#15194)
• [jest-config] Support loading TS config files using esbuild-register via docblock loader (#15190)
• [jest-config] Allow passing TS config loader options via docblock comment (#15234)
• [jest-config] If Node is running with type stripping enabled, do not require a TS loader (#15480)
• [@jest/core] Group together open handles with the same stack trace (#13417, & #14789)
• [@jest/core] Add perfStats to surface test setup overhead (#14622)
• [@jest/core] [BREAKING] Changed --filter to accept an object with shape { filtered: Array<string> } to match documentation (#13319)
• [@jest/core] Support --outputFile option for --listTests (#14980)
• [@jest/core] Stringify Errors properly with --json flag (#15329)
• [@jest/core, @jest/test-sequencer] [BREAKING] Exposes globalConfig & contexts to TestSequencer (#14535, & #14543)
• [jest-each] Introduce %$ option to add number of the test to its title (#14710)
• [@jest/environment] [BREAKING] Remove deprecated jest.genMockFromModule() (#15042)
• [@jest/environment] [BREAKING] Remove unnecessary defensive code (#15045)
• [jest-environment-jsdom] [BREAKING] Upgrade JSDOM to v22 (#13825)
• [@jest/environment-jsdom-abstract] Introduce new package which abstracts over the jsdom environment, allowing usage of custom versions of JSDOM (#14717)
• [jest-environment-node] Update jest environment with dispose symbols Symbol (#14888 & #14909)
• [expect, @jest/expect] [BREAKING] Add type inference for function parameters in CalledWith assertions (#15129)
• [@jest/expect-utils] Properly compare all types of TypedArrays (#15178)
• [@jest/fake-timers] [BREAKING] Upgrade @sinonjs/fake-timers to v13 (#14544 & #15470)
• [@jest/fake-timers] Exposing new modern timers function advanceTimersToFrame() which advances all timers by the needed milliseconds to execute callbacks currently scheduled with requestAnimationFrame (#14598)
• [jest-matcher-utils] Add SERIALIZABLE_PROPERTIES to allow custom serialization of objects (#14893)
• [jest-mock] Add support for the Explicit Resource Management proposal to use the using keyword with jest.spyOn(object, methodName) (#14895)
• [jest-reporters] Add support for DEC mode 2026 (#15008)
• [jest-resolver] Support file:// URLs as paths (#15154)
• [jest-resolve,jest-runtime,jest-resolve-dependencies] Pass the conditions when resolving stub modules (#15489)
• [jest-runtime] Exposing new modern timers function jest.advanceTimersToFrame() from @jest/fake-timers (#14598)
• [jest-runtime] Support import.meta.filename and import.meta.dirname (available from Node 20.11) (#14854)
• [jest-runtime] Support import.meta.resolve (#14930)
• [jest-runtime] [BREAKING] Make it mandatory to pass globalConfig to the Runtime constructor (#15044)
• [jest-runtime] Add unstable_unmockModule (#15080)
• [jest-runtime] Add onGenerateMock transformer callback for auto generated callbacks (#15433 & #15482)
• [jest-runtime] [BREAKING] Use vm.compileFunction over vm.Script (#15461)

... (truncated)

• a383155 v30.0.0
• ce14203 v30.0.0-rc.1
• 0ab14ba v30.0.0-beta.9
• ac334c0 v30.0.0-beta.8
• 7c799e5 v30.0.0-beta.7
• 4f96449 v30.0.0-beta.6
• 286dc4a v30.0.0-beta.5
• 76632c6 chore: drop node 23 (#15640)
• 69f0c89 v30.0.0-beta.4
• 2950cbb Update deps.
• Additional commits viewable in compare view

• See full diff in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore <dependency name> major version will close this group update PR and stop Dependabot creating any more for the specific dependency's major version (unless you unignore this specific dependency's major version or upgrade to it yourself)
• @dependabot ignore <dependency name> minor version will close this group update PR and stop Dependabot creating any more for the specific dependency's minor version (unless you unignore this specific dependency's minor version or upgrade to it yourself)
• @dependabot ignore <dependency name> will close this group update PR and stop Dependabot creating any more for the specific dependency (unless you unignore this specific dependency or upgrade to it yourself)
• @dependabot unignore <dependency name> will remove all of the ignore conditions of the specified dependency
• @dependabot unignore <dependency name> <ignore condition> will remove the ignore condition of the specified dependency and ignore conditions